home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / libelf / elf_getarhdr.z / elf_getarhdr
Encoding:
Text File  |  1998-10-30  |  5.7 KB  |  132 lines
  1.  
  2.  
  3.  
  4. EEEELLLLFFFF____GGGGEEEETTTTAAAARRRRHHHHDDDDRRRR((((3333EEEE))))                                              EEEELLLLFFFF____GGGGEEEETTTTAAAARRRRHHHHDDDDRRRR((((3333EEEE))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _eeee_llll_ffff______gggg_eeee_tttt_aaaa_rrrr_hhhh_dddd_rrrr - retrieve archive member header
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _cccc_cccc [_f_l_a_g ...] _f_i_l_e ...  _----_llll_eeee_llll_ffff [_l_i_b_r_a_r_y ...]
  13.  
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_llll_iiii_bbbb_eeee_llll_ffff_...._hhhh_>>>>
  15.      _EEEE_llll_ffff______AAAA_rrrr_hhhh_dddd_rrrr _****_eeee_llll_ffff______gggg_eeee_tttt_aaaa_rrrr_hhhh_dddd_rrrr_((((_EEEE_llll_ffff _****_eeee_llll_ffff_))))_;;;;
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      _eeee_llll_ffff______gggg_eeee_tttt_aaaa_rrrr_hhhh_dddd_rrrr returns a pointer to an archive member header, if one is
  19.      available for the ELF descriptor _e_l_f.  Otherwise, no archive member
  20.      header exists, an error occurred, or _e_l_f was null; _eeee_llll_ffff______gggg_eeee_tttt_aaaa_rrrr_hhhh_dddd_rrrr then
  21.      returns a null value.  The header includes the following members.
  22.  
  23.                   _cccc_hhhh_aaaa_rrrr            _****_aaaa_rrrr______nnnn_aaaa_mmmm_eeee_;;;;
  24.                   _tttt_iiii_mmmm_eeee______tttt          _aaaa_rrrr______dddd_aaaa_tttt_eeee_;;;;
  25.                   _llll_oooo_nnnn_gggg            _aaaa_rrrr______uuuu_iiii_dddd_;;;;
  26.                   _llll_oooo_nnnn_gggg            _aaaa_rrrr______gggg_iiii_dddd_;;;;
  27.                   _uuuu_nnnn_ssss_iiii_gggg_nnnn_eeee_dddd _llll_oooo_nnnn_gggg   _aaaa_rrrr______mmmm_oooo_dddd_eeee_;;;;
  28.                   _oooo_ffff_ffff______tttt           _aaaa_rrrr______ssss_iiii_zzzz_eeee_;;;;
  29.                   _cccc_hhhh_aaaa_rrrr            _****_aaaa_rrrr______rrrr_aaaa_wwww_nnnn_aaaa_mmmm_eeee_;;;;
  30.  
  31.      An archive member name, available through _aaaa_rrrr______nnnn_aaaa_mmmm_eeee, is a null-terminated
  32.      string, with the _aaaa_rrrr format control characters removed.  The _aaaa_rrrr______rrrr_aaaa_wwww_nnnn_aaaa_mmmm_eeee
  33.      member holds a null-terminated string that represents the original name
  34.      bytes in the file, including the terminating slash and trailing blanks as
  35.      specified in the archive format.
  36.  
  37.      In addition to ``regular'' archive members, the archive format defines
  38.      some special members.  All special member names begin with a slash (_////),
  39.      distinguishing them from regular members (whose names may not contain a
  40.      slash).  These special members have the names (_aaaa_rrrr______nnnn_aaaa_mmmm_eeee) defined below.
  41.  
  42.      _////       This is the archive symbol table.  If present, it will be the
  43.              first archive member.  A program may access the archive symbol
  44.              table through _eeee_llll_ffff______gggg_eeee_tttt_aaaa_rrrr_ssss_yyyy_mmmm.  The information in the symbol table
  45.              is useful for random archive processing [see _eeee_llll_ffff______rrrr_aaaa_nnnn_dddd(3E)].
  46.  
  47.      _////_////      This member, if present, holds a string table for long archive
  48.              member names.  An archive member's header contains a 16-byte area
  49.              for the name, which may be exceeded in some file systems.  The
  50.              library automatically retrieves long member names from the string
  51.              table, setting _aaaa_rrrr______nnnn_aaaa_mmmm_eeee to the appropriate value.
  52.  
  53.      Under some error conditions, a member's name might not be available.
  54.      Although this causes the library to set _aaaa_rrrr______nnnn_aaaa_mmmm_eeee to a null pointer, the
  55.      _aaaa_rrrr______rrrr_aaaa_wwww_nnnn_aaaa_mmmm_eeee member will be set as usual.
  56.  
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. EEEELLLLFFFF____GGGGEEEETTTTAAAARRRRHHHHDDDDRRRR((((3333EEEE))))                                              EEEELLLLFFFF____GGGGEEEETTTTAAAARRRRHHHHDDDDRRRR((((3333EEEE))))
  70.  
  71.  
  72.  
  73. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  74.      _eeee_llll_ffff(3E), _eeee_llll_ffff______bbbb_eeee_gggg_iiii_nnnn(3E), _eeee_llll_ffff______gggg_eeee_tttt_aaaa_rrrr_ssss_yyyy_mmmm(3E), _eeee_llll_ffff______rrrr_aaaa_nnnn_dddd(3E), _aaaa_rrrr(4).
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                                                         PPPPaaaaggggeeee 2222
  129.  
  130.  
  131.  
  132.